<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        
        
        
        <link rel="shortcut icon" href="../img/favicon.ico">
        <title>首页 - Mall Docs</title>
        <link href="../css/bootstrap-custom.min.css" rel="stylesheet">
        <link href="../css/font-awesome.min.css" rel="stylesheet">
        <link href="../css/base.css" rel="stylesheet">
        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/github.min.css">
        <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
        <!--[if lt IE 9]>
            <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
            <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
        <![endif]-->

        <script src="../js/jquery-1.10.2.min.js" defer></script>
        <script src="../js/bootstrap-3.0.3.min.js" defer></script>
        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
        <script>hljs.initHighlightingOnLoad();</script> 
    </head>

    <body>

        <div class="navbar navbar-default navbar-fixed-top" role="navigation">
            <div class="container">

                <!-- Collapsed navigation -->
                <div class="navbar-header">
                    <!-- Expander button -->
                    <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                        <span class="sr-only">Toggle navigation</span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                    </button>
                    <a class="navbar-brand" href="..">Mall Docs</a>
                </div>

                <!-- Expanded navigation -->
                <div class="navbar-collapse collapse">
                        <!-- Main navigation -->
                        <ul class="nav navbar-nav">
                            <li >
                                <a href="..">Home</a>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">User <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../user/user/">Main</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown active">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Mall <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li class="active">
    <a href="./">首页</a>
</li>
                                    
<li >
    <a href="catalog/">分类</a>
</li>
                                    
<li >
    <a href="coupon/">优惠券</a>
</li>
                                    
<li >
    <a href="goods/">产品</a>
</li>
                                    
<li >
    <a href="search/">搜索</a>
</li>
                                    
<li >
    <a href="cart/">购物车</a>
</li>
                                    
<li >
    <a href="address/">地址</a>
</li>
                                    
<li >
    <a href="activity/">活动</a>
</li>
                                    
<li >
    <a href="order/">订单</a>
</li>
                                    
<li >
    <a href="my/">个人中心</a>
</li>
                                    
<li >
    <a href="collect/">收藏</a>
</li>
                                    
<li >
    <a href="aftersale/">售后</a>
</li>
                                    
<li >
    <a href="vip/">会员</a>
</li>
                                    
<li >
    <a href="charge/">充值</a>
</li>
                                    
<li >
    <a href="live/">直播</a>
</li>
                                    
<li >
    <a href="../www/www/">官网</a>
</li>
                                    
<li >
    <a href="invite/">邀请</a>
</li>
                                    
<li >
    <a href="../feed/feed/">圈子</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">管理后台 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../admin/user/">用户</a>
</li>
                                    
<li >
    <a href="../admin/goods/">商品</a>
</li>
                                    
<li >
    <a href="../admin/ad/">推广</a>
</li>
                                    
<li >
    <a href="../admin/topic/">活动</a>
</li>
                                    
<li >
    <a href="../www/www-admin/">官网</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">溯源 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../trace/pda/">PDA</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">中优 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../zhongyou/trading_index/">指数</a>
</li>
                                    
<li >
    <a href="../zhongyou/admin/">后台</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">快递 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../express/express/">app接口</a>
</li>
                                    
<li >
    <a href="../express/express_user/">用户app接口</a>
</li>
                                    
<li >
    <a href="../admin/express/">管理接口</a>
</li>
                                </ul>
                            </li>
                        </ul>

                    <ul class="nav navbar-nav navbar-right">
                        <li>
                            <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
                                <i class="fa fa-search"></i> Search
                            </a>
                        </li>
                            <li >
                                <a rel="next" href="../user/user/">
                                    <i class="fa fa-arrow-left"></i> Previous
                                </a>
                            </li>
                            <li >
                                <a rel="prev" href="catalog/">
                                    Next <i class="fa fa-arrow-right"></i>
                                </a>
                            </li>
                    </ul>
                </div>
            </div>
        </div>

        <div class="container">
                <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
    <ul class="nav bs-sidenav">
        <li class="main active"><a href="#_1">商城首页</a></li>
            <li><a href="#_2">修订记录</a></li>
            <li><a href="#_3">背景</a></li>
            <li><a href="#_4">产品说明</a></li>
            <li><a href="#_5">关键流程说明</a></li>
            <li><a href="#_6">接口说明</a></li>
    </ul>
</div></div>
                <div class="col-md-9" role="main">

<h1 id="_1">商城首页</h1>
<div class="toc">
<ul>
<li><a href="#_1">商城首页</a><ul>
<li><a href="#_2">修订记录</a></li>
<li><a href="#_3">背景</a></li>
<li><a href="#_4">产品说明</a></li>
<li><a href="#_5">关键流程说明</a></li>
<li><a href="#_6">接口说明</a><ul>
<li><a href="#11">1.1 获取首页数据接口</a><ul>
<li><a href="#_7">接口说明</a></li>
<li><a href="#_8">请求说明</a></li>
<li><a href="#_9">输入参数</a></li>
<li><a href="#_10">错误说明</a></li>
<li><a href="#_11">返回实例</a></li>
</ul>
</li>
<li><a href="#12">1.2 今日推荐分页拉取</a><ul>
<li><a href="#_12">接口说明</a></li>
<li><a href="#_13">请求说明</a></li>
<li><a href="#_14">输入参数</a></li>
<li><a href="#_15">错误说明</a></li>
<li><a href="#_16">返回实例</a></li>
</ul>
</li>
<li><a href="#13">1.3 溯源接口</a><ul>
<li><a href="#_17">接口说明</a></li>
<li><a href="#_18">请求说明</a></li>
<li><a href="#_19">输入参数</a></li>
<li><a href="#_20">错误说明</a></li>
<li><a href="#_21">返回实例</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<h2 id="_2">修订记录</h2>
<hr />
<table>
<thead>
<tr>
<th>日期</th>
<th>作者</th>
<th>修订类型</th>
<th>修订内容</th>
<th>版本</th>
</tr>
</thead>
<tbody>
<tr>
<td>2020年07月03日</td>
<td>冷立纲</td>
<td>A</td>
<td>新增设计方案</td>
<td>1.0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>【修订类型：A-新增  M-修改 D-删除】</p>
</blockquote>
<h2 id="_3">背景</h2>
<p>商城首页相关借口</p>
<h2 id="_4">产品说明</h2>
<h2 id="_5">关键流程说明</h2>
<h2 id="_6">接口说明</h2>
<h4 id="11">1.1 获取首页数据接口</h4>
<h5 id="_7">接口说明</h5>
<p>首页数据</p>
<h5 id="_8">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/home/index</td>
</tr>
</tbody>
</table>
<h5 id="_9">输入参数</h5>
<p>无</p>
<h5 id="_10">错误说明</h5>
<h5 id="_11">返回实例</h5>
<pre><code class="json">
{
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
         &quot;defaultKeyword&quot;: {  //默认搜索词
            &quot;id&quot;: 6, //id
            &quot;userId&quot;: null, //用户ID
            &quot;keyword&quot;: &quot;520元礼包抢先领&quot;, //关键词
            &quot;from&quot;: null //涞源
        },
        &quot;banner&quot;: [  //广告
            {
                &quot;id&quot;: 2, //id
                &quot;url&quot;: &quot;http://yanxuan.nosdn.127.net/bff2e49136fcef1fd829f5036e07f116.jpg&quot;, //图片
                &quot;link&quot;: &quot;&quot;, //跳转
                &quot;content&quot;: &quot;活动 美食节&quot;, // 描述
                &quot;type&quot;: 1, //跳转类型 0 h5（取link跳转）  1 产品  2 活动
                &quot;idValue&quot;: 1110016,  // 1: 对应产品ID  2: 对应活动ID
                &quot;extParams&quot;: null

            }
        ],
        &quot;daySelectList&quot;: [ //每日优选
            {
                &quot;id&quot;: 5,   //id
                &quot;imageUrl&quot;: &quot;http://yanxuan.nosdn.127.net/ 65091eebc48899298171c2eb6696fe27.jpg&quot;, //图片
                &quot;content&quot;: &quot;测试&quot;, //描述
                &quot;addTime&quot;: null, //添加时间
                &quot;goodsId&quot;: 1006002 //产品ID
            }
        ],
        &quot;couponList&quot;: [  //优惠券
            {
                &quot;id&quot;: 9,  //id
                &quot;name&quot;: &quot;测试一下&quot;, //名称
                &quot;desc&quot;: &quot;&quot;,  //描述
                &quot;tag&quot;: &quot;&quot;, //标签
                &quot;total&quot;: null, //总量
                &quot;discount&quot;: 0.00, //优惠金额
                &quot;min&quot;: 100.00, //最小使用金额
                &quot;limit&quot;: null, //限制
                &quot;type&quot;: null, //优惠券赠送类型，如果是0则通用券，用户领取；如果是1，则是注册赠券；如果是2，则是优惠券码兑换；
                &quot;goodsType&quot;: null, //商品限制类型，如果0则全商品，如果是1则是类目限制，如果是2则是商品限制。
                &quot;startTime&quot;: null,  //使用券开始时间
                &quot;endTime&quot;: null,  //使用券截止时间
                &quot;addTime&quot;: null,
                &quot;imageUrl&quot;: null //图片
                &quot;own&quot;:false //是否已拥有
            }
        ],
        &quot;categoryList&quot;: [  //品类
            {
                &quot;id&quot;: 1005000,  //类别ID
                &quot;name&quot;: &quot;居家&quot; //类别名称
            }
        ],
        &quot;goodsList&quot;: {  //产品信息
            &quot;pageSize&quot;: 10,  //单页条数
            &quot;total&quot;: 5,  //总条数
            &quot;currentPage&quot;: 1,  //当前页
            &quot;list&quot;: [
                {
                    &quot;id&quot;: 1006002,  //产品id
                    &quot;name&quot;: null, //名称
                    &quot;tags&quot;: [], //数组
                    &quot;picUrl&quot;: &quot;http://yanxuan.nosdn.127.net/8ab2d3287af0cefa2cc539e40600621d.png&quot;,  //图片
                    &quot;unit&quot;: null,  //单位
                    &quot;counterPrice&quot;: 919.00,  //专柜价
                    &quot;retailPrice&quot;: 899.00, //销售价
                    &quot;vipPrice&quot;: null, //会员价
                    &quot;brief&quot;: null  //运营描述
                    &quot;gallery&quot;:[&quot;http://yanxuan.nosdn.127.net/8ab2d3287af0cefa2cc539e40600621d.png&quot;], //图片
                    &quot;videos&quot;:[
                        {
                            &quot;url&quot;:&quot;/xxxx&quot;,
                            &quot;cover&quot;:&quot;cover&quot;,
                            &quot;size&quot;:&quot;x*y&quot;
                        }
                    ]
                }

            ],
            &quot;unit&quot;: &quot;条&quot;,
            &quot;extInfo&quot;: null,
            &quot;endIndex&quot;: 10,
            &quot;nextPage&quot;: 1,
            &quot;previousPage&quot;: 1,
            &quot;totalPages&quot;: 1,
            &quot;startIndex&quot;: 0,
            &quot;firstPage&quot;: true,
            &quot;lastPage&quot;: true,
            &quot;empty&quot;: false
        }
    }
}
</code></pre>

<h4 id="12">1.2 今日推荐分页拉取</h4>
<h5 id="_12">接口说明</h5>
<p>首页每日优选，拉取更多</p>
<h5 id="_13">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/day_selected/list</td>
</tr>
</tbody>
</table>
<h5 id="_14">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">page</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">页码</td>
<td align="left">默认值 1</td>
</tr>
<tr>
<td align="left">limit</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">单页条数</td>
<td align="left">默认值 10</td>
</tr>
</tbody>
</table>
<h5 id="_15">错误说明</h5>
<h5 id="_16">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;pageSize&quot;: 10,
        &quot;total&quot;: 1,
        &quot;currentPage&quot;: 1,
        &quot;list&quot;: [
            {
                &quot;id&quot;: 1006002,  //产品ID
                &quot;name&quot;: &quot;轻奢纯棉刺绣水洗四件套&quot;, //名称
                &quot;tags&quot;: null,  //标签
                &quot;picUrl&quot;: &quot;http://yanxuan.nosdn.127.net/8ab2d3287af0cefa2cc539e40600621d.png&quot;,
                &quot;unit&quot;: &quot;件&quot;, //单位
                &quot;counterPrice&quot;: 919.00,  //专柜价
                &quot;retailPrice&quot;: 899.00, //零售价
                &quot;vipPrice&quot;: 100000.00, //会员价
                &quot;brief&quot;: &quot;设计师原款，精致绣花&quot;, //简介
                &quot;gallery&quot;:[&quot;http://yanxuan.nosdn.127.net/8ab2d3287af0cefa2cc539e40600621d.png&quot;], //图片
                &quot;videos&quot;:[
                        {
                            &quot;url&quot;:&quot;/xxxx&quot;,
                            &quot;cover&quot;:&quot;cover&quot;,
                            &quot;size&quot;:&quot;x*y&quot;
                        }
                    ]
            }
        ],
        &quot;unit&quot;: &quot;条&quot;,
        &quot;extInfo&quot;: null,
        &quot;endIndex&quot;: 10,
        &quot;startIndex&quot;: 0,
        &quot;firstPage&quot;: true,
        &quot;lastPage&quot;: true,
        &quot;nextPage&quot;: 1,
        &quot;previousPage&quot;: 1,
        &quot;totalPages&quot;: 1,
        &quot;empty&quot;: false
    }
}

</code></pre>

<h4 id="13">1.3 溯源接口</h4>
<h5 id="_17">接口说明</h5>
<p>溯源产品</p>
<h5 id="_18">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get/post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/home/tracing</td>
</tr>
</tbody>
</table>
<h5 id="_19">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">data</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">二维码内容</td>
<td align="left"></td>
</tr>
</tbody>
</table>
<h5 id="_20">错误说明</h5>
<h5 id="_21">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;tracingResult&quot;: [
            {
                &quot;label&quot;: &quot;身份唯一码&quot;,
                &quot;value&quot;: &quot;2022307987285385&quot;
            },
            {
                &quot;label&quot;: &quot;产品名称&quot;,
                &quot;value&quot;: &quot;庆沣祥•白莺山春古茶（2016）&quot;
            },
            {
                &quot;label&quot;: &quot;规格&quot;,
                &quot;value&quot;: &quot;357g/片&quot;
            },
            {
                &quot;label&quot;: &quot;成品生产日期&quot;,
                &quot;value&quot;: &quot;2016年4月1日&quot;
            },
            {
                &quot;label&quot;: &quot;出品公司&quot;,
                &quot;value&quot;: &quot;昆明七彩云南庆沣祥茶业股份有限公司&quot;
            },
            {
                &quot;label&quot;: &quot;生产厂/监制人&quot;,
                &quot;value&quot;: &quot;勐海七彩云南茶厂有限公司/罗翔辉&quot;
            },
            {
                &quot;label&quot;: &quot;仓储信息&quot;,
                &quot;value&quot;: &quot;2016年6月入七彩云南陈华仓&quot;
            },
            {
                &quot;label&quot;: &quot;检验报告编号&quot;,
                &quot;value&quot;: &quot;Y142016-WB00196&quot;
            },
            {
                &quot;label&quot;: &quot;检验机构&quot;,
                &quot;value&quot;: &quot;国家普洱茶产品质量监督检验中心&quot;
            },
            {
                &quot;label&quot;: &quot;检验指标及检验情况&quot;,
                &quot;value&quot;: &quot;1.重金属—合格   2.农残—合格&quot;
            },
            {
                &quot;label&quot;: &quot;原料来源&quot;,
                &quot;value&quot;: &quot;   精选普洱茶核心产区白莺山古茶园树龄百年以上的云南大叶种晒青毛茶原料，古法精制而成。&quot;
            }
        ],
        &quot;goods&quot;: {
            &quot;id&quot;: 1181000,
            &quot;name&quot;: &quot;母亲节礼物-舒适安睡组合&quot;,
            &quot;picUrl&quot;: &quot;http://yanxuan.nosdn.127.net/1f67b1970ee20fd572b7202da0ff705d.png&quot;,
            &quot;unit&quot;: &quot;件&quot;,
            &quot;counterPrice&quot;: 0.09,
            &quot;retailPrice&quot;: 0.01,
            &quot;vipPrice&quot;: 0.01,
            &quot;brief&quot;: &quot;安心舒适是最好的礼物&quot;,
            &quot;gallery&quot;: [
                &quot;http://yanxuan.nosdn.127.net/355efbcc32981aa3b7869ca07ee47dac.jpg&quot;,
                &quot;http://yanxuan.nosdn.127.net/43e283df216881037b70d8b34f8846d3.jpg&quot;,
                &quot;http://yanxuan.nosdn.127.net/12e41d7e5dabaf9150a8bb45c41cf422.jpg&quot;,
                &quot;http://yanxuan.nosdn.127.net/5c1d28e86ccb89980e6054a49571cdec.jpg&quot;
            ],
            &quot;videos&quot;: null,
            &quot;tags&quot;: null
        },
        &quot;daySelectList&quot;: null
    }
}

</code></pre></div>
        </div>

        <footer class="col-md-12">
            <hr>
            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
        </footer>
        <script>
            var base_url = "..",
                shortcuts = {"search": 83, "next": 78, "help": 191, "previous": 80};
        </script>
        <script src="../js/base.js" defer></script>
        <script src="../search/main.js" defer></script>

        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
                <h4 class="modal-title" id="exampleModalLabel">Search</h4>
            </div>
            <div class="modal-body">
                <p>
                    From here you can search these documents. Enter
                    your search terms below.
                </p>
                <form role="form">
                    <div class="form-group">
                        <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
                    </div>
                </form>
                <div id="mkdocs-search-results"></div>
            </div>
            <div class="modal-footer">
            </div>
        </div>
    </div>
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="Keyboard Shortcuts Modal" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
                <h4 class="modal-title" id="exampleModalLabel">Keyboard Shortcuts</h4>
            </div>
            <div class="modal-body">
              <table class="table">
                <thead>
                  <tr>
                    <th style="width: 20%;">Keys</th>
                    <th>Action</th>
                  </tr>
                </thead>
                <tbody>
                  <tr>
                    <td class="help shortcut"><kbd>?</kbd></td>
                    <td>Open this help</td>
                  </tr>
                  <tr>
                    <td class="next shortcut"><kbd>n</kbd></td>
                    <td>Next page</td>
                  </tr>
                  <tr>
                    <td class="prev shortcut"><kbd>p</kbd></td>
                    <td>Previous page</td>
                  </tr>
                  <tr>
                    <td class="search shortcut"><kbd>s</kbd></td>
                    <td>Search</td>
                  </tr>
                </tbody>
              </table>
            </div>
            <div class="modal-footer">
            </div>
        </div>
    </div>
</div>

    </body>
</html>
